Coffee Break now handles help through the Help on Wheels help engine, by Ross Brown of AWOL Software Productions, available from my own ftp site (see the end of this document) or through the Anarchie bookmark included in the package. (If you can't find a copy, you may send me a disk and a stamped, self-addressed disk mailer, and I'll send you a copy.) If you don't have Help on Wheels, however, activating the on-line help will give you the option to save the help text as a TeachText document.
WHAT IT IS:
Coffee Break is a simple application that is designed to force you to take periodic breaks, so that you can reduce your chances of getting a Repetetive Stress Injury. You may set an amount of "work time", during which Coffee Break sits in the background with a timer displayed, and an amount of "break time", or "sleep time", during which you are forced to take a break from the computer. For more information about how to use Coffee Break, see the on-line help. (From within Coffee Break, choose Help from the File menu, Coffee Break Help from the Balloon Help menu, press the Help key (on an Extended keyboard), or press Cmd-? to access the on-line help.)
LEGALITIES:
This documentation must be included with all copies of Coffee Break. Do not give out copies of this program without the documentation. This program is available for all non-commercial use, so please feel free to pass it along to your friends. It may not be sold for profit without the author's written permission.
SHAREWARE NOTICE:
This program is Shareware, and if you decide to keep it, you should send in a registration fee of $5, along with a brief note, which should include your e-mail address (if you have one). If you like it, please do! You'll help me put my wife through medical school! :-) You'll also ensure that I continue to write more programs, and continue to improve Coffee Break. To register, send a check or cash (in U.S. dollars) to the snail mail address at the end of this file. Thanks, and I hope you like it!
However, the real purpose behind this program is to help all you hackers and other serious typists out there keep in good health! ;-) So, if it comes down to it and you decide you can't afford to register it, use it anyway. Health is the prime concern here, not making money! I'm trusting you to register it if you can.
SYSTEM REQUIREMENTS:
Coffee Break requires System 7.x. It uses strictly System 7 routines for it's background/foreground switches and other things. So, there's no need to even TRY it on a machine running Sys 6. It should run on ANY machine capable of running System 7, however. It will also run just fine under System 7.5.1.
Some of the special features depend on certain screen saver options. Different screen savers support some, all, or none of these options. Listed below is a table of which screen savers I've tested with the program and what options (from the Set Options dialog) they support. For a complete description of these options, see the on-line help.
Saver: Pause when saver on: Built-in saver only:
AfterDark 2.0x yes yes
AfterDark (pre-2.0x) yes no
Basic Black 1.3.1 yes yes
Darkside of the Mac 4.1 yes no*
* note that while Darkside does not support the "Built-in saver" option, it does let you turn this option on. However, if you do, you still won't get any of the benefits of this option.
As you can tell, many screen savers DON'T support these options. I've tried nearly every screen saver I could find, and these are the only ones that are friendly enough to tell other programs of their existance. However, I've found that the ones listed above are the most widely-used screen savers.
Also, note that if you have Darkside, you should change the name of either Darkside or Coffee Break so that Coffee Break loads AFTER Darkside. If Coffee Break loads first, the screen saver options will turn themselves off, as they won't detect that a screen saver is installed. I'll undoubtedly try to compensate for this in future releases.
Also, note that the program's memory requirements are currently set to 110K. This is 20K more than is necessary. The reason for this is that, if you don't have Help on Wheels, you'll need that extra 20K to save the help text to a TeachText file. If you've already saved the help to a file, or you have Help on Wheels, you may reduce the memory requirements to 90K. This will hopefully be fixed in a future version.
(Note: if you don't know how to do this, here's how. Click on Coffee Break in the Finder, choose Get Info from the File menu, and change the Preferred size field to 90.)
INTRODUCTION:
This program was inspired in me two years ago (1993), when I became concerned about Repetetive Stress Injuries (RSI). Since I work with computers both at work and at home, I'm setting myself up for RSI. I didn't want that to happen. So, having heard of a shareware program that would force you to take breaks at certain intervals, I looked into it. Unfortunately, it fell short of my expectations. So, I wrote my own, and fixed all of the problems I had with it.
When I first heard that such a program existed, I thought it was a stupid idea. I've obviously since changed my mind, and I've found Coffee Break to be VERY useful. I hope that you do, too.
A DEBATED OPTION:
One of the options in this program, the Restrict user option, was the source of much debate between my beta testers and myself. Some felt, as I did, that the program should be heavy-handed -- to protect against our weak willpower. However, others felt that there needed to be ways to quit and to exit sleep mode. In an attempt to satisfy both parties, this option was added. It is slightly difficult to turn off, but turning this option off gives the ability to quit and to exit sleep mode.
As a service to registered users who feel that this feature is too much of a temptation, I will provide a version of the program with this feature disabled. If you are a registered user and would like a copy of the disabled program, you may either send me an e-mail message requesting the program, or send a self-addressed, stamped disk mailer, a blank disk, and a letter requesting the program.
KNOWN PROBLEMS:
This program doesn't work well when you're playing games such as Maelstrom, which take over completely during the game. (Note: Maelstrom doesn't have a monopoly on this problem, by a long shot. I just figured everyone would know what I was talking about if I used a common example.) I haven't actually tried it in some time, but I'm sure it probably will still not work well. In addition, one game (Arashi) uses the same method to tell a program it's covering the screen as the Coffee Break-compatible screensavers listed above. In such a case, Coffee Break's timer will remain paused as long as you're playing. This is obviously a problem, but there's not much I can do to fix this.
It would be nice if I would write fixes for these problems, but there's not much I can do. I have tried to make it work as cleanly as possible with such games.
CREDITS:
First of all, I'd like to thank Pete Gontier for his help in installing the AfterDark Gestalts. I made the screensaver portion of this program install the same Gestalts that it likes other screen savers to have. (See the table above.) Without Pete's help, I probably would have thrown my hands up in dispair trying to figure it out.
Thanks to Keith Rollin for helping me with a few other bugs, such as version 1.1's problems with multiple monitors.
Thanks to Ross Brown and AWOL Software Productions for making Help on Wheels and the Help on Wheels developer's kit.
Thanks to Craig O'Donnell for allowing me to use a sound from his Cool Mac Sounds book.
I'd also like to thank all my initial beta-testers. They not only helped me iron out many of the intermittent bugs, but they also gave me many invaluable suggestions, without which this program would not be what it is today. Thanks to Derek A. Borgford, Flint S. Hahn, Al Heynneman, Devon Hubbard, Chris Hwang, Ken Linger, Kathy Peck, Eric Thompson, Sean Vadras, and Harvey Wong. You guys were a HUGE help!
I'd like to thank the numerous people on the Internet who have, at some time or another, answered questions for me about technical problems. I'd also like to thank the people who convinced me this idea wasn't stupid. (Yes, at one point, I thought the idea of a program like this was stupid. I obviously think differently now.)
Thanks to Metrowerks for writing CodeWarrior. Thanks to Symantec for THINK Reference. Thanks to Hypercard clip art for providing the basis of some of the art in the screensaver portion of the program. Thanks to whoever at Apple wrote ResEdit. (And good luck on getting a newer version out! nudge, nudge...) Thanks to Apple for making the Macintosh, without which none of this would be here.
HOW TO CONTACT ME:
If you want to send me a message through e-mail, you can contact me at:
ThomasReed@aol.com
For registration purposes, or if you don't have access to e-mail, here's my snail mail address:
Thomas Reed
1912 McCausland
St. Louis, MO 63117
WHEN YOU REGISTER, PLEASE SEND A BRIEF NOTE TO TELL ME WHAT YOUR E-MAIL ADDRESS IS, IF YOU HAVE ONE.
Hope you like Coffee Break!
Also look for my games! Try Valley of Peril, if you're into adventure games! It's freeware, so there's no charge! Also try The Solitaire of Champions if you like solitaire games.
